Download data from the Catalan automatic weather station network (XEMA from Servei Meteorol<U+00F2>gic de Catalunya)
downloadSMCvarmetadata(api, type = "current")
downloadSMCstationlist(api, date = NULL)
downloadSMCcurrentday(api, daily_meteoland = TRUE, variable_code=NULL,
station_id=NULL, date = Sys.Date(), verbose=TRUE)
downloadSMChistorical(api, dates, station_id=NULL, variable_code=NULL, export = FALSE,
exportDir = getwd(), exportFormat = "meteoland/txt",
metadataFile = "MP.txt", verbose=TRUE)
String with the SMC API key (the procedure to apply for an api key is explained in https://apidocs.meteocat.gencat.cat/ ).
Either 'current' or 'historical' for current day variable metadata or historical variable metadata, respectively.
When daily_meteoland = TRUE
all the usual variables in meteoland are downloaded and aggregated at the daily scale. When daily_meteoland = FALSE
, the user can choose the desired variables using variable_code
.
A character vector with variable codes to be queried. If NULL
in downloadSMChistorical
all the usual variables for meteoland are downloaded. Otherwise, the results are returned as a dara frame.
An object of class Date
with dates comprised within the last two years.
An object of class Date
. By default the current day in the case of downloadSMCcurrentday()
. In the case of downloadSMCstationlist()
a date for which operational stations are queried.
A string vector containing station ids (the list of stations for which climatic series are available is given by downloadSMCstationlist()
). If NULL
, all available stations are queried. Otherwise, only the data corresponding to the specified stations will be returned.
If export = FALSE
the downloaded data is stored in memory. Otherwise the result is written on the disk (using the format specified in exportFormat
).
Output directory for downloaded meteorology.
Format of meteorological data. Current accepted formats are "castanea"
and "meteoland"
.
The name of the file that will store the meta data describing all written files.
Boolean flag to print process information.
Function downloadSMCstationlist
returns a SpatialPointsDataFrame-class
object containing the list of SMC operational weather stations for the date given.
Function downloadSMCvarmetadata
returns a data frame with weather variables, their units and acronym to be used in queries (see parameter variable_code
).
Function downloadSMCcurrentday
downloads recent weather (the last 24h or the weather for a given date) from all currently available stations and returns data frame if daily_meteoland = FALSE
or a SpatialPointsDataFrame-class
object with observations aggregated at the daily scale otherwise.
Function downloadSMChistorical
downloads historical daily weather corresponding to a given time period from a set (or all currently available) stations. Results are returned (or exported) after formatting data as a SpatialPointsMeteorology-class
if variable_code = NULL
, or as a data frame otherwise.
API key needs to be requested from SMC (https://apidocs.meteocat.gencat.cat/).
Servei Meteorol<U+00F2>gic de Catalunya (SMC) should be acknowledged as author of information when accessing weather data with these functions.